-
Notifications
You must be signed in to change notification settings - Fork 137
docs: add 5 community tools to docs/community/tools/ #320
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: add 5 community tools to docs/community/tools/ #320
Conversation
Add comprehensive documentation for community-contributed tools: - strands-hubspot: READ-ONLY HubSpot CRM integration with safe data access - strands-teams: Microsoft Teams notifications with Adaptive Cards - strands-telegram: Complete Telegram Bot API with 60+ methods - strands-telegram-listener: Real-time message processing with AI auto-replies - strands-deepgram: Speech & audio processing with 30+ language support Each tool follows the community contribution format with: - Installation instructions - Usage examples - Key features - Configuration requirements - Resource links All tools are production-ready with comprehensive error handling, type safety, and detailed documentation for community adoption.
zastrowm
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for these, looking pretty good and almost ready to merge.
I've left a couple of comments - could we update the entries to:
- Have some yaml frontmatter (not blocking, but helpful)
- Update the links in the entry paragraph (per comments)
- (nit - align Requried/Optional comments)
|
Are any of these replaced by https://github.com/eraykeskinmac/strands-tools-community? And/or did you want to call out https://github.com/eraykeskinmac/strands-tools-community in any of these pages? |
- Added YAML frontmatter with project and service information - Changed GitHub links to be primary (instead of PyPI first) - Added service provider links (Deepgram, HubSpot, Teams, Telegram) - Removed Strands SDK links (redundant in docs) - Fixed environment variable alignment with proper comments - Updated HubSpot link to working developer docs URL - Added strands-tools-community meta-package references - Fixed all issues raised by zastrowm in PR review
The strands-tools-community meta-package is deprecated as all tools are now distributed as individual packages on PyPI. Removed the alternative installation references from all tool documentation.
Good question! No, the I originally created it as a meta-package to bundle all tools together, but decided to distribute each tool individually on PyPI instead. This approach provides:
I've removed all references to the deprecated meta-package from the documentation. Each tool now stands alone as its own PyPI package:
Thanks for catching this! The docs are now cleaner without the outdated references. |
Add strands-tools-examples repository link to all tool documentation. This provides users with working examples, complete workflows, and interactive demos for testing all community tools. Repository includes: - Individual tool examples with real-world workflows - Interactive demo agent with REPL interface - Complete setup guide with environment variables - Telegram bot examples with AI-powered auto-replies - End-to-end integration examples combining multiple tools Example repository: https://github.com/eraykeskinmac/strands-tools-examples
- Remove 'strands-agents[anthropic]' from installation as it's inconsistent - Usage example uses default Agent() which works with Bedrock by default - Users can still install anthropic separately if they prefer - Keeps documentation consistent and simple
Head branch was pushed to by a user without write access
Proposed Content
I would like to propose adding 5 community tools to the Community Tools documentation, each as separate files following the utcp.md format.
Added Tools:
1. strands-hubspot
2. strands-teams
3. strands-telegram
4. strands-telegram-listener
5. strands-deepgram
Notes:
@zastrowm:
Screenshots
Format Compliance
Each tool file follows the established pattern from utcp.md:
{{ community_contribution_banner }}includedCommunity Value
These tools fill critical gaps in the Strands ecosystem: